home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xvc / XSGIvcSetOutputGain.z / XSGIvcSetOutputGain
Text File  |  1998-10-30  |  8KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn((((3333))))                     XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSGIvcSetOutputGain, XSGIvcQueryOutputGain - Video Gain
  10.           Operations
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXX11111111////eeeexxxxtttteeeennnnssssiiiioooonnnnssss////XXXXSSSSGGGGIIIIvvvvcccc....hhhh>>>>
  14.  
  15.           vvvvooooiiiidddd XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
  16.               iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
  17.               iiiinnnntttt cccchhhhaaaannnnnnnneeeellll,,,,
  18.               iiiinnnntttt ccccoooommmmppppoooonnnneeeennnnttttIIIIDDDD,,,,
  19.               ffffllllooooaaaatttt ggggaaaaiiiinnnn))))
  20.  
  21.           SSSSttttaaaattttuuuussss XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
  22.               iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
  23.               iiiinnnntttt cccchhhhaaaannnnnnnneeeellll,,,,
  24.               iiiinnnntttt ccccoooommmmppppoooonnnneeeennnnttttIIIIDDDD,,,,
  25.               ffffllllooooaaaatttt ****ggggaaaaiiiinnnnRRRReeeettttuuuurrrrnnnn))))
  26.  
  27.      PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  28.           _d_i_s_p_l_a_y     Specifies the connection to the X server.
  29.  
  30.           _s_c_r_e_e_n      Specifies the screen of the X server.
  31.  
  32.           _c_h_a_n_n_e_l     Specifies the channel number.
  33.  
  34.           _c_o_m_p_o_n_e_n_t_I_D Specifies the color component which is the
  35.                       subject of the call.  This can be one of
  36.                       XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____RRRREEEEDDDD, XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____GGGGRRRREEEEEEEENNNN,
  37.                       XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____BBBBLLLLUUUUEEEE, XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____AAAALLLLPPPPHHHHAAAA,
  38.                       or XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____AAAALLLLLLLL.
  39.  
  40.           _g_a_i_n        The value to which the gain should be set.
  41.  
  42.           _g_a_i_n_R_e_t_u_r_n  Pass a pointer to the location which is to
  43.                       receive the value to which the color component
  44.                       gain is set.
  45.  
  46.  
  47.  
  48.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  49.           These functions allow alteration and query of video gain
  50.           values and is intended for use by color correction and gamma
  51.           management tools.  Arbitrary use of this control may
  52.           conflict with these tools.
  53.  
  54.           The gain value is specified in arbitrary units, where the
  55.           following are points of interest:
  56.  
  57.           _0._0    Lowest useful value
  58.  
  59.           _1._0    Nominal value
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn((((3333))))                     XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn((((3333))))
  71.  
  72.  
  73.  
  74.           _1_0._0   Highest possible value
  75.  
  76.  
  77.           Precision depends upon server implementation and although is
  78.           monotonically increasing is not guaranteed to be uniform
  79.           across the full range.  You should use XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn
  80.           to retrieve the current setting from the server after a set
  81.           operation to determine the value to which the server is set.
  82.           XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn(((()))) sets the video output gain of the
  83.           components of a channel.
  84.  
  85.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn(((()))) returns the current settings for
  86.           each of the components of a channel.
  87.  
  88.  
  89.         CCCCoooommmmppppoooonnnneeeennnntttt SSSSppppeeeecccciiiiffffiiiiccccaaaattttiiiioooonnnn
  90.           A server may support independent adjustment of each
  91.           component, or may support only a global change; refer to
  92.           hardware documentation for information on server support or
  93.           reference the XXXXSSSSGGGGIIIIVVVVCCCC____CCCCIIIIFFFFPPPPeeeerrrrCCCCoooommmmppppoooonnnneeeennnnttttGGGGaaaaiiiinnnn mask bit in the
  94.           field _c_h_a_n_n_e_l_F_l_a_g as returned in the XXXXSSSSGGGGIIIIVVVVCCCCQQQQuuuueeeerrrryyyyCCCChhhhaaaannnnnnnneeeellllIIIInnnnffffoooo
  95.           function.  This mask bit is True when the server supports
  96.           independent gain adjustment of each component on the
  97.           channel.  Applications written for use on more than one type
  98.           of hardware should query all color component values after
  99.           setting one.
  100.  
  101.           For servers that permit independent adjustment, any
  102.           component of XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____RRRREEEEDDDD, XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____GGGGRRRREEEEEEEENNNN,
  103.           XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____BBBBLLLLUUUUEEEE, or XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____AAAALLLLPPPPHHHHAAAA may be
  104.           specified.  For servers that support only simultaneous,
  105.           ganged change of the gain for all components, use
  106.           XXXXSSSSGGGGIIIIVVVVCCCC____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____AAAALLLLLLLL.
  107.  
  108.  
  109.      EEEEVVVVEEEENNNNTTTTSSSS
  110.           When this control is altered, the server generates a
  111.           OutputGainNotify event.
  112.  
  113.  
  114.      RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE
  115.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn returns TRUE if successful, FALSE upon
  116.           failure.
  117.  
  118.           Parameter errors are reported via BadValue or BadMatch.
  119.  
  120.  
  121.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.           XSGIvc
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.